Shareware Grab Bag

home *** CD-ROM | disk | FTP | other *** search

/ Shareware Grab Bag / Shareware Grab Bag.iso / 090 / newweb.arc / WEB.DOC < prev next >

Wrap

Text File | 1985-08-30 | 16.8 KB | 494 lines

WEB COMMAND SHELL V2.0 USER MANUAL (C) Copyright 1985 Jonathan Wesener Public Domain Software The WEB command shell is distributed under the USER-SUPPORTED concept. You are encouraged to copy and share this program with other users. If you find the shell useful and want continued updates and support for this program, please send a donation of an amount you feel suitable. HOWEVER, with donations of $30 and up you will recieve complete, documented source on diskette for the latest version of this shell. By the way, this was written entirely in Assembler and C. SPECIAL NOTE: I am not liable for damages, commercial or noncommercial, consequential or otherwise from use of this program. Also, if there are additions, or deletions of commands, etc, that would make this program easier and more useful, please write and tell me what they are. Jonathan Wesener 8020 S. Park Rd. Wis. Rapids, WI 54494 August 1985 0- 0 CONTENTS: Chapter 0 INSTALLATION 0.1 WEBDEV.SYS ...................................... 0- 1 Chapter 1 COMMANDS 1.1 ALTer (File Attributes) ......................... 1- 1 1.2 CLS (Clear Screen) .............................. 1- 1 1.3 COPY (Files) .................................... 1- 2 1.4 DELete (Files) .................................. 1- 2 1.5 DIRectory (List Files) .......................... 1- 3 1.6 MD (Make Directory) ............................. 1- 3 1.7 MEMory (Show memory & Disk Space) ............... 1- 4 1.8 REName (Files) .................................. 1- 4 1.9 RD (Remove directory) ........................... 1- 4 1.10 SD (Set Default) ................................ 1- 5 1.11 SET (Symbol) .................................... 1- 5 1.12 SUBmit (Batch File) ............................. 1- 6 1.13 TYPE (File) ..................................... 1- 6 1.14 QUIT (RETURN TO DOS) ............................ 1- 6 1.15 ECHO (Echo line to Standard Output) ............. 1- 7 1.16 REM (Remark) .................................... 1- 7 Chapter 2 HISTORY Chapter 3 ODDS AND ENDS 3.1 REDIRECTION ..................................... 3- 1 3.2 UPDATES ......................................... 3- 1 0- 1 INSTALLATION Before you use this program, make sure you have the character device WEBDEV.SYS on your boot disk and include in CONFIG.SYS: device=webdev.sys Without this, the command shell will act very strangely indeed. This device is a write only character device which allows you to partition the screen into window like areas. Standard output is set to the device WINDOW defined by WEBDEV which controls and formats all output to be confined to a portion of the screen. You can use this with other programs for windowing effects by installing the device as above and then telling the device through escape sequences what you want it to do. The known escape sequence are : <ESC>A# - Set display attribute of characters <ESC>C#### - Create a window <ESC>E - Erase defined window <ESC>P# - Set display page of the window Note: The # sign represents a byte value between 0 - 255. For the Create window, the first two numbers represent the upper left corner of the window and the second to numbers are the lower right corner of the window. If invalid values are give for #, the results will be unpredictable such as giving an invalid page number. ALSO, This device is meant to be used with the screen in the 80X25 modes and the results are unkown for any other mode. 1- 1 COMMAND - ALTer PURPOSE - Change file attributes of READ, SYSTEM and HIDDEN. USAGE - ALT [Path\]Name /[RHS] SWITCHES- R = READ ONLY H = HIDDEN S = SYSTEM EXAMPLES: ALT A:\FILE.DAT /H ALT SECRET.FIL /RHS ALT NORM.FIL / ALT FILE.ATT NOTE: This command allows you to SET or VIEW the attributes of a specified file. To VIEW the attributes, leave off the switch. If the file exists the attributes, if any, will be displayed. To SET the attributes use the switch followed by zero or more of the switch characters. Zero characters will make the file normal. Invalid switch characters are ignored. COMMAND - CLS PURPOSE - Clear the screen and home the cursor. USAGE - CLS NOTE: This command will not act right if the screen is in a graphics mode. 1- 2 COMMAND - COPY PURPOSE - Make copies of a file. USAGE - COPY [Path]name [Path][name] EXAMPLES: COPY A: B: COPY SUBDIR COPY *.OBJ SUBDIR NOTE: This command will try to copy the specified files, (wild cards are usable) to the specified, or unspecified file. If no destination is specified, the current directory with the files previous name are used. WARNING: There is a danger of copying a file over itself by a command of COPY FILE.DAT with no destination. This could trash your file, so be careful. Any ideas on how to check for this would be appreciated. ALSO, If the diskette you're copying to is empty, you might have problems. The version of DOS I used has trouble recoginizing empty directories, so COPY WEB.DOC A: will not work, but COPY WEB.DOC A:\WEB.DOC will. As soon as there are files on the disk DOS starts working, again. COMMAND - DEL PURPOSE - Delete unwanted files from device. USAGE - DEL [PATH][name] [/C] SWITCH - C = Confirm files deletion EXAMPLES: DEL DEL SUBDIR /C DEL *.OBJ DEL /C DATA.FIL NOTE: If no name is specified, the current directory or the specified path will be deleted. If there is ever a TOTAL deletion you will be asked (Y/N) are you sure to avoid doing something regretable. If you use the confirm switch, you will be given a (Y/N) prompt for each file to be deleted. This is handy for selective purges! 1- 3 COMMAND - DIR PURPOSE - List the files in a directory USAGE - DIR [PATH][NAME] [/DHW] SWITCHES- D = Suppress the listing of Directories H = Show all hidden and system files W = Give four names to a line without statistics EXAMPLES: DIR DIR SUBDIR /DH DIR *.OBJ DIR /W *.obj NOTE: This is pretty much like the usual DIR command except that it doesn't give the listings path, volume name or free disk space. The amount of free disk space can be gotten with a different command, namely MEM (1- 4). The switch can be placed in front of or behind the path, this lets you set up your own default listing with the SET command, (1- 5). COMMAND - MD PURPOSE - Make subdirectory USAGE - MD [path]NAME EXAMPLE: MD SUBDIR NOTE: For more information see SD and RD. 1- 4 COMMAND - MEM PURPOSE - Display the current amount of free memory and free disk space on the current drive. USAGE - MEM NOTE: The current amount of free memory is displayed in bytes and in paragraphs. A paragraph is the smallest amount of memory you can allocate from DOS and consists of 16 bytes. COMMAND - REN PURPOSE - Rename files on a single device. USAGE - REN [PATH]name [PATH][NAME] EXAMPLES: REN SUBDIR\*.OBJ REN *.OBJ SUBDIR REN FILE1 FILE2 NOTE: This is almost exactly like copy except that you can't rename a file across devices, like a: to b:, and instead of making a copy of the file, it moves the file. COMMAND - RD PURPOSE - Remove Directory USAGE - RD [PATH]name EXAMPLES: RD SUBDIR RD a:\SUB1\SUBDIR NOTE: A directory cannot be removed if there are files in it, or if it is the current default directory. 1- 5 COMMAND - SD PURPOSE - Set default directory USAGE - SD [PATH] EXAMPLES: SD SD ..\SUBDIR SD SUBDIR SD A:\SUBDIR SD A:SUBDIR NOTE: If no path is specified, the current default setting will be returned. Also, The '..' directory is how you step out of a directory once you're in it. SD .. will take you back one level as long as you're not in the root directory. COMMAND - SET PURPOSE - To display and set symbols to be converted before the command line is interpreted. USAGE - SET [SYM] [STRING] EXAMPLES: SET SET DIR DIR /W SET CD SD SET DEL DEL /C SET DATA A:\DATA\DATA.FIL SET %1 FILE.C SET "DIR NOTE: This is probably this shell's biggest feature. There is a 1/2K of memory set aside for a symbol table. When you enter a command at the prompt, each word seperated by white space is checked to see if it has an entry in the symbol table, if it does, the word is replaced with its string from the table. This allows you to tailor the shell to your own standards. IF YOU DON'T WANT A WORD ON THE COMMAND LINE CONVERTED, precede it with a double quote, ("). This is necessary for deleting symbols. You can also include redirection of input and output within a symbol. EX 1: displays all the symbols that are defined EX 2: will cause all DIR's to default wide listing EX 3: makes CD behave like the usual command shell command EX 6: One way to pass in arguments to batch files EX 7: How to delete a defined word. 1- 6 COMMAND - SUB PURPOSE - Submit batch files USAGE - SUB [PATH] name EXAMPLES: SUB CC.BAT SUB CC SUB SUBDIR\CC NOTE: This command will probably die if the current drive or default is changed by a command in the batch file. This command uses the PATH set up in the environment by the usual command shell to search for the file if it is not in the current directory. This is a simple batch processor which has no errorlevel checking or the usual parameter passage. However, some information can be sent in via symbols, see SET, 1- 5. ALSO, The batch files do not have to have the .BAT extension, although its a good idea for record keeping and the batch file name AUTO.WEB is reserved. If there is a batch file named AUTO.WEB in the current default directory when WEB is started up, it will AUTOMATICALLY BE SUBMITTED as if it were the first command entered. This is useful for setting up symbol definitions. This is the WEB counterpart to AUTOEXEC.BAT. COMMAND - TYPE PURPOSE - Display a specified file to standard output. USAGE - TYPE [PATH] NAME EXAMPLES: TYPE A:\SUBDIR\DATA.DAT TYPE FILE.C NOTE: This is just what you'd expect it to be. COMMAND - QUIT PURPOSE - To exit the WEB command shell and return to DOS. USAGE - QUIT 1- 7 COMMAND - ECHO PURPOSE - For batch files to tell what they are doing. USAGE - ECHO text COMMAND - REM PURPOSE - To put comments in batch files for documentation, etc. USAGE - REM text 2- 1 HISTORY Another benefit of this shell is a four command history which is available at the command prompt. These work totally different than from those of the normal command shell. KEY DEFS: HOME : Go to beginning of prompt END : Go one character beyond last non white space LFTARR : Move cursor left one character RGTARR : Move cursor right one character PGUP : Move up through previous command list PGDWN: Move down through previous command list DEL : Del current character INS : Toggle between insert and exchange mode ESC : Delete all characters from cursor to end of line. CTRL-LFTARR : Previous word. CTRL-RGTARR : Next word. NOTE: The function keys have NO meaning. This command shell has two command cursors, The usual blinking underscore and a white block character. The white block character is for the command line and when it is present, the shell is expecting input from you. The other cursor is in the display field and has no real function. 3- 1 Redirection: Yes, WEB has redirection and it works the usual way. To redirect standard input, use: <FILE.NAM To redirect standard output, use: >FILE.NAM NOTE: WEB doesn't support the appending of standard output. So, >>FIL.NAM will NOT WORK. UPDATES I plan on updating this shell to include new features and/or fix any bugs. Your input is probably the most important thing in keeping this going. I would like responses on the following areas: A: What should the Maximum size of this program be ? B: What commands should the BATCH processor include ? C: What commands should be expanded or shrunk ? D: What new commands could be added ? E: How can the manual be improved ? F: Do you want the function keys to be programmable ? G: Are there any deadly bugs to be squashed ?